home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / omkrd201.arc / OMKREAD.DOC < prev    next >
Text File  |  1992-01-03  |  43KB  |  1,255 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         INTRODUCTION
  8.  
  9.          
  10.         WELCOME TO OPUS MESSAGE KIT!!  This program, OMKREAD.EXE, is an
  11.         off-line reader which will allow you to read, write and reply to
  12.         messages on any Opus Bulletin Board which carries Opus Message Kit
  13.         AND systems which carry the QWK message format.  
  14.  
  15.         The system is written and owned by Roland "Bud" Brown and is the 
  16.         product of several years of work.  However, unlike many systems
  17.         today Opus Message Kit is totally FREE.  There is no cost to you or
  18.         the BBS for using Opus Message Kit (OMK).  
  19.  
  20.         OMK is a gift to the BBS community by Roland and the PainFrame
  21.         Pointers.  The Pointers are a group of friends who went through the
  22.         trauma several years ago of setting up mail points off of the
  23.         PainFrame BBS (1:261/1004) here in Baltimore.  While it was rough
  24.         in the beginning, we have had a wonderful time sharing our
  25.         "hobby/passion" for computers. Opus Message Kit was born out of our
  26.         desire to allow folks the opportunity to become points "PainLessly"
  27.         off their favorite Opus Bulletin Boards.  The Pointers (named
  28.         individually at the end of this document) spent many hours debug-
  29.         ging, testing, and helping design OMK.  We hope that you will find
  30.         the system enjoyable. 
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.         1.    OPUS MESSAGE KIT OVERVIEW 
  74.          
  75.         OPUS Message Kit is an offline reader designed for use on OPUS and
  76.         other BBS systems which use Opus Message Kit or the QWK off-line
  77.         message format.  It enables you to: 
  78.          
  79.         -     Select message areas on a bulletin board.  
  80.         -     Archive messages from those areas.  
  81.         -     Download the messages. 
  82.         -     Read and reply to the messages offline on your own computer, 
  83.               and create new messages if you desire. 
  84.         -     Upload the replies and messages you have created to the       
  85.               bulletin board, where they are placed in the correct message  
  86.               areas. 
  87.  
  88.         When you log onto a BBS carrying Opus Message Kit, or QWK, the
  89.         sysop provides a way for you to select the message areas you would
  90.         like track and to "bundle" (pack up) messages in those  areas.  OMK
  91.         or the QWK format bundler, bundles your messages, and you download
  92.         the file containing the messages to your own computer.   
  93.  
  94.         The reader (OMKREAD.EXE), when installed on your computer, prepares
  95.         the bundle of messages for your use and provides you with a simple
  96.         environment for reading and responding to them at your own pace.  A
  97.         text editor of your choice (see Section 2) is used to create your
  98.         replies and new messages. When you are ready, OMK prepares your
  99.         replies and new messages for transmittal to the bulletin board. 
  100.         You use your normal communications program, call the bulletin
  101.         board, and follow instructions for uploading your messages.   
  102.          
  103.         It's that simple.  You no longer need to worry about running out of
  104.         time when you follow a large echo, or decide not to answer a
  105.         message because you need to look up a reference.  No more concerns
  106.         about tying up the board.  You do all that off-line on your own
  107.         system in your own time.  
  108.  
  109.         AND ALL FOR FREE! So what's the catch?  Well, we do ask that you
  110.         let us know that you are using OMK.  Don't worry; this isn't a way
  111.         to send you a bill. Because of the author's job he is not allowed
  112.         to charge for this kind of work . . . so you're safe.  It's just
  113.         that we've spent a long time getting this system ready, and we're
  114.         really interested in the folks who are using it. 
  115.           
  116.         So, to let us know all you have to do is send Net Mail to:  
  117.          
  118.                          Sysop 1:261/1055  
  119.  
  120.           1:261/1055 is The Keeping Room BBS the main beta test site of 
  121.         OMK, and the Sysop is Anne Madison (the documentation guru for 
  122.         Opus Message Kit).  Or, if you don't have access to Net Mail a
  123.         brief note via U.S. Mail would be appreciated.  Send to:  
  124.                        Roland M. Brown III  
  125.                        7538 Main Street  
  126.                        Sykesville, Md. 21784  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.           
  140.         PLEASE, NO PHONE CALLS! EVEN ON YOUR DIME ROLAND CANNOT AFFORD THE
  141.         TIME.  
  142.  
  143.         While you're writing, let us hear your comments, complaints, and
  144.         compliments.  If you find a bug, heaven forbid, WE WANT TO KNOW
  145.         ABOUT THAT AS WELL.   
  146.  
  147.         DISCLAIMER:  OMKREAD is provided free of charge.  The program is
  148.         provided "as is" with no guarantees or warranties of any kind. 
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.         2.    SYSTEM REQUIREMENTS:  WHAT YOU NEED TO USE OPUS MESSAGE KIT 
  207.          
  208.         -     An IBM personal computer or true compatible with hard disk. 
  209.          
  210.         -     A TEXT EDITOR.  There are two requirements for the text       
  211.               editor:  
  212.          
  213.              (a)  It must accept the name of the file to be edited as its   
  214.                   first command-line parameter (for example, "ED FILENAME"
  215.                   or "Q FILENAME." 
  216.          
  217.               (b)    It must be capable of creating PURE ASCII TEXT FILES.  
  218.                      You cannot use your regular word-processor with OMK 
  219.                      unless it is capable of creating an ASCII (or DOS      
  220.                      Text) file.  Word-processors include control and other 
  221.                      codes in the documents they create which are 
  222.                      incompatible with OMK.  
  223.            
  224.              We recommend PC-WRITE, or QEdit, both user supported programs
  225.              readily available on most bulletin boards. OMK has been tested
  226.              with both of these editors and we know that they work well     
  227.              with OMK.  However, the program should work with any editor    
  228.              meeting those two requirements.   
  229.           
  230.         -    The PKZIP and PKUNZIP file compression programs.  Beginning
  231.              with this version of OMK, the use of PKZIP/PKUNZIP is
  232.              mandatory.  If you plan to use your reader on bulletin boards
  233.              using an older version of OMK you must also have a a file
  234.              compression program which creates ARC format files.  Three
  235.              which are   readily available are ARCA/ARCE, PKARC/PKXARC, and
  236.              PKPAK/PKUNPAK. 
  237.          
  238.         -    And, of course a communications program!  A REALLY NICE free
  239.              communications program is \/\/term written by Walter Cox who
  240.              was instrumental in helping with OMK.  With its autoZmodem
  241.              uploading and downloading it makes and IDEAL choice for
  242.              OMK/BBS messaging.  
  243.          
  244.         Version 2.0x of the OMK Reader will handle messages for all previ-
  245.         ous versions of OPUS Message Kit as well as QWK.
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.         3.    INSTALLING OPUS MESSAGE KIT ON YOUR SYSTEM 
  273.          
  274.         This section provides complete instructions for installation of the
  275.         OPUS Message Kit Reader on your PC.  The installation will include
  276.         the following steps: 
  277.          
  278.         -    Decide on, and create, directories on your hard disk for the
  279.              OMK reader, the text editor you have selected, the file
  280.              compression utilities, and bundles of messages coming into and
  281.              out of the OMK reader. 
  282.         -    Add the OMK directory to your path.  Optionally, add the
  283.              directories housing your editor and compression utilities to 
  284.              the path. 
  285.         -    Run the OMKREAD program and answer some configuration ques-
  286.              tions. 
  287.          
  288.         3.1   PREPARING YOUR SYSTEM 
  289.          
  290.               3.1.1  Create the OMK Subdirectory 
  291.          
  292.              Create a subdirectory on your HARD DISK for the OPUS Message
  293.              Kit.  You may name the subdirectory anything you like. 
  294.              Unarchive the reader OMK_READ.ARC into the subdirectory.   
  295.                
  296.               3.1.2  Create the Upload/Download Subdirectory 
  297.          
  298.              Decide which subdirectory on your system you would like to
  299.              download your messages to and upload your messages from.  It
  300.              is probably easiest to choose the subdirectory or sub-
  301.              directories you have already specified for this purpose in
  302.              your communications program (for example, C:\new or
  303.              C:\download).  
  304.          
  305.               3.1.3  Create the Message Subdirectories If Desired 
  306.          
  307.              Decide where you would like to keep the messages from each BBS
  308.              you will be calling which uses OMK.  In most cases, it is
  309.              simplest just to keep the messages in your main OPUS Message 
  310.              Kit subdirectory; however, you may specify any subdirectory
  311.              you choose.  OMK will create the actual BBS subdirectories. 
  312.          
  313.               3.1.4  Create the Editor Subdirectory 
  314.          
  315.              Decide on a subdirectory for your EDITOR if you don't already
  316.              have one set up.  Again, if you prefer, the editor can reside
  317.              in the OMK reader subdirectory.  
  318.          
  319.               3.1.5  Create the PKZIP Subdirectory 
  320.          
  321.              If you don't have one already, create a subdirectory on your
  322.              hard disk for PKZIP/PKUNZIP and the other ARC utility you've
  323.              selected.  Place the PKZIP/PKUNZIP utilities in this sub-
  324.              directory.  IF YOU'RE A NOVICE AT USING THESE KINDS OF
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.              UTILITIES, FAMILIARIZE YOURSELF WITH THEIR DOCUMENTATION. 
  338.              Most of them require simple, but very specific, installation
  339.              procedures before you can use them.  Become familiar with
  340.              these instructions before you begin to use OMK.  If you don't
  341.              plan to use a BBS with an old version of OMK, you won't need
  342.              the ARC utility.  If you don't wish to create a special
  343.              subdirectory for these utilities, they can be placed in the
  344.              same subdirectory with OPUS Message Kit.   
  345.          
  346.               3.1.6  Modify your PATH Statement 
  347.          
  348.              Add the OMK subdirectory to your PATH. You may also add the
  349.              archive utility subdirectory (if it is different), and the
  350.              Editor subdirectory (if it is different) to your PATH. If you
  351.              do not choose to do this, a path may be included when you
  352.              install OMK.  Set up a path by adding the following statement-
  353.              (s) to your autoexec.bat: 
  354.          
  355.               path=C:\omkread;C:\arcutils;C:\qedit 
  356.               (or whatever drive and sub-directory names you've chosen) 
  357.          
  358.              Be sure to REBOOT your computer after adding this statement so
  359.              that the PATH is in effect when you begin to use OMKREAD.   
  360.          
  361.         This completes your system preparation.  Next, you will be running
  362.         and configuring the reader.   
  363.  
  364.         3.2   RUNNING OMKREAD FOR THE FIRST TIME 
  365.          
  366.         You should run OMKREAD once before you have a message bundle to
  367.         read.  The first time you run it, several configuration options
  368.         will be set.  Be certain you have available the names and locations
  369.         of the subdirectories you created in Step 3.1 above.  You may want
  370.         to jot them down. 
  371.          
  372.               3.2.1  Required Subdirectories 
  373.          
  374.              The reader will find the subdirectory where its own program is
  375.              located and verify that this is where you want it to reside. 
  376.              This is the subdirectory you created in Step 3.1.1, above.  It
  377.              will then ask you where the inbound messages are and where to
  378.              put its replies. The answer to this question will be the
  379.              subdirectory you decided on in Step 3.1.2.   You will then be
  380.              asked where you would like OMK to "create" the BBS's you'll be
  381.              getting messages from.  This will be the subdirectory you
  382.              decided on in Step 3.1.3.  You will be asked to specify your
  383.              editor.  This will be the subdirectory you decided on in Step
  384.              3.1.4. 
  385.          
  386.               3.2.2  Your Screen Colors 
  387.          
  388.              OMK will next provide you with the opportunity to select your
  389.              screen colors using windows OMK provides for this purpose. 
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.              3.2.4  Your File Compression Utilities 
  404.          
  405.              You will be asked to select an ARCHIVE PROGRAM from a list. 
  406.              PKZIP will always be the default, but if you plan to use this
  407.              reader with messages prepared on a BBS using an older version
  408.              of OMK you MUST also have an ARC type program.  If you don't
  409.              plan to use OMK on bulletin boards using an ARC utility, don't
  410.              worry about it.  Just pick one from the list, even if you
  411.              don't have it. If you're in doubt about which utility is being 
  412.              used on any BBS, just ask the sysop. 
  413.           
  414.         3.3  UPGRADING FROM AN OLDER VERSION OF OMK 
  415.          
  416.         IF you are already using OMK and wish to upgrade to version 2.0,
  417.         follow these two steps: 
  418.          
  419.               3.3.1  Get a Copy of PKZIP/PKUNZIP 
  420.          
  421.              Be certain you have a recent copy of PKZIP/PKUNZIP and that it
  422.              is in a subdirectory on your path. 
  423.          
  424.               3.3.2  Unarchive the New OMK Reader 
  425.                
  426.              Unarchive a copy of the new reader in your current OMKREAD
  427.              subdirectory. The new reader will automatically pick up your
  428.              parameters from your old version. 
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.         4.  USING OPUS MESSAGE KIT ON AN OMK BBS 
  471.          
  472.         THAT'S IT!  The OPUS Message Kit reader has been installed, and
  473.         you're ready to log into your favorite OPUS Message Kit BBS and
  474.         DOWNLOAD SOME MESSAGES.   
  475.          
  476.         4.1  The Net/Node Number 
  477.          
  478.         While you're there, be sure to take CAREFUL note of your sysop's
  479.         FIDONET Net/Node number.  The number is unique on every BBS.  It
  480.         usually consists of two or three digits, followed by a slash, then 
  481.         three or four digits.  There may be some extra numbers included. 
  482.         Example: 
  483.          
  484.                                    1:261/1055.0 
  485.          
  486.         The important digits here would be 261/1055.  The Net/Node number
  487.         is often displayed on the BBS's opening screen (what you see when
  488.         you first log in).  If you don't see it, make a point of asking the
  489.         sysop.  Your message and reply bundles will be named using this
  490.         net/node number, so for the above system the file names would be: 
  491.          
  492.                      02611055.REZ (for the reply bundles you upload) 
  493.                      02611055.OKZ (for message bundles you download) 
  494.          
  495.         4.2  The OPUS Message Kit Bundler 
  496.          
  497.         The following overview is divided into two parts.  Section 4.2.1
  498.         refers to bulletin board systems where the sysop has enabled 
  499.         message downloading and uploading from within OMK.  Section 4.2.2
  500.         provides instructions for those systems where this feature is not
  501.         enabled.  Ask your sysop which procedures you should follow.   
  502.          
  503.          
  504.               4.2.1  Boards Which Use OMK for Message Uploads/Downloads 
  505.          
  506.              Follow the sysop's instructions for getting into OPUS Message
  507.              Kit on the BBS.  You are presented with a list of message
  508.              areas; they're the same areas you normally see on the bulletin
  509.              board.  You may select any of these areas to receive in your
  510.              Reader.  Select the desired message areas by typing their
  511.              numbers in, one at a time, each followed by a space.  Press
  512.              <enter> when you have completed your selections. 
  513.          
  514.              You are next asked for a DATE from which to begin bundling. 
  515.              If this is your first time using the reader, you'll automatic-
  516.              ally be given the date on which the sysop last configured OPUS
  517.              Message Kit on the BBS. Your first OMK session will be easier
  518.              and more successful if you enter YESTERDAY'S DATE here. 
  519.              Popular message areas receive many new messages every day, and
  520.              you can quickly find yourself with a message bundle which is
  521.              too large to manage easily.  So be conservative on your first
  522.              visit.  You'll soon develop a feel for how often you need to
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.              download your messages.  On your second and subsequent calls,
  536.              your default date will be the last date you received messages. 
  537.              Occasionally (not on your first call) you may need to RESELECT
  538.              your message areas.  This simply means that the sysop  has
  539.              been doing some work on the configuration of OMK.  
  540.          
  541.              You are next asked if you wish to download your messages.  Two
  542.              file transfer protocols are provided:  Zmodem and CRC Xmodem. 
  543.              If you wish to download your messages from within OMK, answer
  544.              Y(es) and start the download on your system just as you would
  545.              for any other file transfer.  Check your communications prog-
  546.              ram for instructions on how to use it to download files. 
  547.  
  548.              After you have downloaded your new messages, you will be asked
  549.              if you wish to upload a bundle of messages to the board. 
  550.              Answer "Y" if you have messages to upload.  You will be asked
  551.              to select a file transfer protocol--Zmodem or CRC Xmodem. 
  552.              Type in the number of the protocol you wish to use.  Your
  553.              reply bundle (if you have one) is automatically named
  554.              NNNNNNNN.REZ, "N" being the Fidonet net/node number of the
  555.              bulletin board.  For net/node number 261/1055, the reply
  556.              bundle would be named 02611055.REZ. The reply bundle is
  557.              located in the directory of your hard disk which you specified
  558.              in Section 3.1.2, above.  Start the upload by following the
  559.              procedures in your communications program for uploading files.
  560.              It's IMPORTANT not to upload your messages to any area of the
  561.              board other than that specified by the sysop.  When you have
  562.              finished uploading your bundle, you are ready to exit the OMK
  563.              bundler.
  564.  
  565.              That's it.  Do whatever else it is you normally do when
  566.              "visiting" the BBS, then log off and you are ready to read and 
  567.              respond to your messages using the OMK Reader you've installed 
  568.              on your own system. 
  569.          
  570.                4.2.3  Boards Which Use a File Area for Message  
  571.                      Uploads/Downloads 
  572.          
  573.              Follow the sysop's instructions for getting into OPUS Message
  574.              Kit on the BBS. You are presented with a list of message
  575.              areas; they're the same areas you normally see on the bulletin
  576.              board.  You may select any of these areas to receive in your
  577.              Reader.  Select the desired message areas by typing their
  578.              numbers in, one at a time, each followed by a space.  Press
  579.              <enter> when you have completed your selections. 
  580.  
  581.              You are next asked for a DATE from which to begin bundling. 
  582.              If this is your first time using the reader, you'll
  583.              automatically be given the date on which the sysop last
  584.              configured OPUS Message Kit on the BBS. Your first OMK session
  585.              will be easier and more successful if you enter YESTERDAY'S
  586.              DATE here. Popular message areas receive many new messages
  587.              every day, and you can quickly find yourself with a message
  588.              bundle which is too large to manage easily.  So be
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.              conservative on your first visit.  You'll soon develop a feel
  602.              for how often you need to download your messages.  On your
  603.              second and subsequent calls, your default date will be the
  604.              last date you received messages. Occasionally (not on your
  605.              first call) you may need to RESELECT your message areas.  This
  606.              simply means that the sysop has been doing some work on the
  607.              configuration of OMK.  
  608.          
  609.              Next, exit OMK and return to the bulletin board. As you leave
  610.              OMK, you are directed to a file area (NOT A MESSAGE AREA) on
  611.              the board which the sysop has set up for OPUS Message Kit. You
  612.              see your message bundle waiting there for you, and you can
  613.              download it with any transfer protocol used on the board.
  614.              Check your communications programs for instructions on how to
  615.              use it to download a file.  Check with your sysop if you need
  616.              instructions for how to download a file from the file area. 
  617.  
  618.              After you have downloaded your new messages, you will be asked
  619.              if you wish to upload a bundle of messages to the board. 
  620.              Answer "Y" if you have messages to upload.  You may use any
  621.              transfer protocol offered by the bulletin board to upload your
  622.              reply bundle.  Your reply bundle (if you have one) is
  623.              automatically named NNNNNNNN.REZ, "N" being the Fidonet
  624.              net/node number of the bulletin board.  For net/node number
  625.              261/1055, the reply bundle would be named 02611055.REZ. The
  626.              reply bundle is located in the directory of your hard disk
  627.              which you specified in Section 3.1.2, above.  Start the upload
  628.              by following the procedures in your communications program for
  629.              uploading files. 
  630.          
  631.              IMPORTANT:  Don't upload your reply bundle to any other area
  632.              on the board.  Don't use the special OMK area to upload any
  633.              other files. 
  634.           
  635.              That's it.  Do whatever else it is you normally do when
  636.              "visiting" the BBS, then log off and you are ready to read and 
  637.              respond to your messages using the OMK Reader you've installed
  638.              on your own system. 
  639.  
  640.              BBSes with QWK provide similar facilities allowing you to
  641.              designate areas to bundle and to download messages and upload
  642.              replies.
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.         5.    USING YOUR OMK READER 
  669.          
  670.         5.1   Getting Into the OMK Reader 
  671.           
  672.         Users of DOS 2.x MUST always CD (change directory) to the OMK
  673.         directory BEFORE using the reader.  When using 3.x or greater OMK
  674.         can find its directory no matter where you call it from as long as
  675.         the directory is EITHER in your path statement or explicitly
  676.         specified (i.e. d:\omk\omkread).  
  677.          
  678.         When you run the reader it will check (messages you have just
  679.         downloaded) from the BBS. The messages will be unbundled and 
  680.         prepared for reading.  You can keep messages from many bulletin
  681.         board systems on your system; OMK will keep track of them within
  682.         the reader.  
  683.          
  684.               5.1.1  Command Line Options 
  685.          
  686.                                         -l 
  687.          
  688.              This command line switch tells OMK to bypass displaying the
  689.              BBS logo when you "logon" the BBS in the reader.  Normally, if
  690.              the BBS sends you a logo file, it is always displayed when you
  691.              select that BBS with your reader.  If you use the -l option
  692.              that file is not displayed.  The "Logo" command on the main
  693.              menu allows you to display the logo while you are reading
  694.              message.  This is useful since some bulletin boards send
  695.              useful information (such as a list of new uploads) in their
  696.              logo files. 
  697.          
  698.          
  699.                                         -b
  700.  
  701.              This option allows you to use the BIOS video routines rather
  702.              than OMK's normal direct memory video routines.  While this
  703.              option slows OMK's screen display CONSIDERABLY, it does allow
  704.              the reader to run as a "well-behaved" program under certain
  705.              multi-tasking systems such as DesqView. 
  706.          
  707.                                         -r
  708.          
  709.              This option allow you to RETAIN messages between unbundles. 
  710.              Prior to this version OMK_READ always deleted old messages on
  711.              the reader when there were new messages to unbundle.  With
  712.              this option the reader will add new messages to the end of
  713.              each area.  This works well when you only track small message
  714.              areas on a BBS.  Be warned that when you attempt this with a
  715.              large area like DR_DEBUG you will need LOTS of disk space! 
  716.              You can delete messages from the Main Reader Menu if disk
  717.              space becomes a problem.
  718.  
  719.  
  720.          
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.         5.2   THE MAIN MENU 
  734.          
  735.         The main menu provides you with the following options: 
  736.  
  737.         -    Log on:  OMK will show you a list of available BBSes and
  738.              permit you to select the BBS you want to work with. OMK does 
  739.              this by checking for existing message bundles you have
  740.              downloaded.   
  741.           
  742.         -    Reconfigure:  Allows you to reset your OMK system parameters
  743.              including: paths to inbound messages and outbound replies;
  744.              your text editor, your archive program, the location of the
  745.              BBS messages, and the screen color settings.  If you change
  746.              the location of your inbound messages (FROM THE BBS) you will
  747.              need to quit OMKREAD and call it again for that new directory
  748.              to take effect.  This is not necessary if you change the
  749.              directory for the outbound messages. That change takes effect
  750.              immediately. 
  751.          
  752.         -    Delete Msgs:  Allows you to delete ALL messages for any BBS.
  753.              You are stepped through each BBS which has messages and
  754.              allowed to select whether or not to delete messages for that
  755.              BBS.  A bundle of replies is forced before ANY messages are
  756.              deleted, as a safeguard.  
  757.  
  758.         -    Params:  Will show you your parameters that you have set for
  759.              OMKREAD.
  760.           
  761.         -    Quit:  Quits the OMK READER.  A scan of all BBS message areas
  762.              and a bundle of any replies is done prior to exiting the
  763.              program.  You are also given an opportunity to delete any OLD
  764.              reply bundles from your outbound reply area.  
  765.          
  766.          
  767.         5.3  Reading Messages for a BBS  
  768.          
  769.         Use "LOGON" from the main menu to select the BBS whose messages you
  770.         want to read and reply to.  If this is your first time out, you'll
  771.         probably only have one BBS to choose from.  Simply type in the
  772.         number of the BBS you've selected.  Once you have selected your
  773.         BBS, read the messages by following the steps in this section.
  774.          
  775.               5.3.1  Start with a Message Area 
  776.  
  777.              Once you've selected a BBS you'll be presented with a list of
  778.              message areas.  Each will have its own OMK message area
  779.              number, a descriptive title, and the number of messages to be
  780.              read.  Areas where there are new messages will be highlighted.
  781.              (CGA USERS NOTE: This highlighting does not show up well with
  782.              some color combinations.) 
  783.          
  784.               5.3.2  Message Options
  785.  
  786.              Once you have selected a message area, a blank message screen
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.              will appear. You will find that reading through the messages
  800.              is very similar to the process you use when reading them on a
  801.              BBS.  The following message options are provided at the bottom
  802.              of your screen: 
  803.          
  804.              -    NEXT: Read the next message 
  805.          
  806.              -    PRIOR: Read the previous message 
  807.          
  808.              -    REPLY: Reply to the message you are reading 
  809.          
  810.              -    WRITE:  Enter a new message 
  811.          
  812.              -    MSG#: Read a specific message (by number) 
  813.          
  814.              -    KILL: Kill a message or reply (by number) 
  815.          
  816.              -    AREA: Change to another message area 
  817.          
  818.              -    XPORT: Export (save) a message to a separate text file on
  819.                   your disk (useful for messages which contain information
  820.                   you might want save for future reference). OR Save a
  821.                   message to your printer by specifying PRN LPT1 LPT2 etc. 
  822.          
  823.                   If you specify an existing file OMK will append the
  824.                   message to that file (add it to the end).  You could
  825.                   specify a file name like CECHO.DAT and put any messages
  826.                   you want to track from the C_echo into that file. 
  827.          
  828.              -    LOGO:  Re-display the BBS logo for the current BBS. Note:
  829.                   you can use the command line parameter -l (lower case l)
  830.                   to bypass the logo display when you log onto the BBS
  831.                   using the reader. 
  832.          
  833.              -    INQUIRE:   Find a text string in a message header (TO,
  834.                   FROM, SUBJECT)
  835.          
  836.              -    SHELL:  Jump to DOS on your system.  Return to OMK by
  837.                   typing "EXIT"  
  838.  
  839.              -    BYE:  Quit reading messages and return to the main OMK
  840.                   menu. You can also do this by pressing ESCAPE. 
  841.          
  842.              All of these options are HOT KEYS. Just press the first
  843.              CAPITAL letter of the desired option.  All return to "Next"
  844.              after completion except Prior which is 'sticky' like Next. 
  845.  
  846.              WHEN you are reading messages and this menu is NOT visible you
  847.              can use the PGUP/PGDN and up and down ARROW keys to scroll
  848.              your messages on screen.
  849.          
  850.          
  851.         5.4   Writing or Replying to Messages 
  852.          
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.               5.4.1  Message Headers 
  866.          
  867.              When you decide to write or answer a message (by selecting the
  868.              WRITE or REPLY option), you'll be asked to enter the header
  869.              (TO, FROM, SUBJECT) if it's a new message.  If it's a reply,
  870.              you'll be asked to accept or change the SUBJECT.  You will
  871.              also be asked if the message is public or private.  Messages
  872.              are automatically public unless you specify private by
  873.              answering "No" to the prompt. 
  874.          
  875.               5.4.2  The Message Text 
  876.          
  877.              Your text editor will now come into play.  You'll be presented
  878.              with the main editing screen of the editor you selected when
  879.              you installed OMK. If you are creating a reply, you will see
  880.              the entire text of the original message displayed Edit out
  881.              portions of the original message you don't want to quote, and
  882.              type in your reply. If you are entering a new message, you can
  883.              simply begin typing the message. 
  884.          
  885.               5.4.1  Saving your Message 
  886.          
  887.              When you have completed the message or reply, USE WHATEVER
  888.              COMMAND YOU NORMALLY USE IN YOUR EDITOR TO QUIT AND SAVE A
  889.              FILE.  OPUS Message Kit will take the message you have just
  890.              created and save it to be bundled with other messages and
  891.              replies.    
  892.          
  893.         You can continue reading, writing, and replying to messages.  When
  894.         you're ready to change to a new message area, select AREA CHANGE
  895.         from the menu at the bottom of your screen.   
  896.          
  897.         5.5  FINISHING UP 
  898.          
  899.         When you are ready to stop reading and replying to messages, select
  900.         BYE (or press ESCAPE).  You can go on to read messages from another
  901.         BBS or exit the Reader.   
  902.          
  903.         When you exit the Reader, you will see the it packing up your
  904.         replies for each BBS and placing them in the upload subdirectory
  905.         you specified when you installed it. You'll be given the
  906.         opportunity to DELETE any old message packets that exist. IT IS
  907.         BEST TO GET INTO THE HABIT OF DOING THIS IF YOU HAVE ALREADY
  908.         UPLOADED THE REPLIES IN THE OLD PACKET. You do not have to delete
  909.         old replies if you are not sure whether or not you have uploaded 
  910.         them.   
  911.  
  912.         HOWEVER with QWK format BBS you SHOULD delete old replies since
  913.         MOST QWK systems we have encountered DO NOT have the sophisticated
  914.         date checking routines OMK uses to prevent DUPES to the BBS.  If
  915.         you keep uploading QWK.REP packets that you have uploaded before
  916.         you may get (understandably) NASTYGRAMS from the Sysop.
  917.  
  918.          
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.         OMK date stamps each  bundle within each outbound message archive.
  932.         The BBS unbundler will not create duplicate messages on the BBS. 
  933.         IT IS ALWAYS WISER to delete your old replies yourself.  If you
  934.         don't, you may eventually get a "nastygram" from the sysop because
  935.         OMK on the bulletin board takes extra time to process old messages. 
  936.         So make it a habit to DELETE YOUR REPLY BUNDLES after you have
  937.         uploaded them.       
  938.          
  939.         Opus Message Kit can handle multiple sessions of the reader.  Say,
  940.         for instance, that you've downloaded some messages from a BBS and
  941.         written replies and some new messages, and then said BYE.  You then
  942.         quit OMK and your replies/messages are bundled.  You decide it is
  943.         too late to log onto the BBS and go to bed, or you suddenly
  944.         remember that there is another message you need to write.  You call
  945.         the reader again, log onto the BBS and write more messages, say BYE
  946.         and quit again.  OMK bundles your messages and date/time stamps
  947.         them and ADDS then to the bundle that it created earlier.  No
  948.         messages are lost. 
  949.          
  950.  
  951.         5.6  A WORD OF WARNING: YOUR SYSTEM DATE 
  952.           
  953.         Opus Message Kit is DATE SENSITIVE.  Please be certain that you
  954.         enter the system date and time correctly, or that your system clock
  955.         is correct.  One OMK user didn't notice that his system clock had
  956.         somehow been set for the year 2074.  He created a bundle of
  957.         messages with that date and uploaded them.  The next time he
  958.         attempted to use OPUS Message Kit on that BBS (after he had
  959.         corrected his system clock), OMK refused any of his bundles because
  960.         they were all dated prior to 2074 (naturally).  If this should
  961.         happen to you ask the sysop to check and possibly reset your last
  962.         date bundle using the BBS program OMK_USRM.EXE.    
  963.  
  964.         5.7 USING OMKREAD WITH A QWK BBS
  965.  
  966.         QWK BBS messaging is very similar in concept to OMK.  There are a
  967.         few differences, however, which you should know about.  First, QWK
  968.         BBSes often let you choose between various archive methods.  When
  969.         using OMKREAD YOU MUST CHOOSE PKZIP!!  
  970.  
  971.         The file name will NOT be the net/node numbers you use on an OMK
  972.         BBS.  Instead, the sysop assigns a name.  For example, Anne
  973.         Madision calls her QWK packets TKR.QWK and the replies for her BBS
  974.         will always be TKR.REP.  You don't need to worry about this OMKREAD
  975.         takes care of all of this automatically.  You will only need to
  976.         remember that *.REP files are QWK replies, while *.QWK files are
  977.         QWK messages from the BBS.  OMKREAD will keep them separate.  
  978.  
  979.         You'll only need to remember the name that goes with each BBS when
  980.         time comes for you to upload your replies (*.REP) to the BBS. 
  981.         Don't worry most sysops assign names that you will easily associate
  982.         with their BBS -- like TKR for The Keeping Room, or AVITECH!.REP
  983.         for Avitechnic BBS, or TNCBBS.REP for the Nerve Center BBS. 
  984.         Simple!!
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.         6.   THAT'S IT!
  998.  
  999.         We hope you'll find OPUS Message Kit convenient and easy to use. 
  1000.         Please feel free to share it with other boards and users. We ask
  1001.         only that you distribute the archive in its original form. Don't
  1002.         forget to LET US KNOW ABOUT YOUR EXPERIENCES with it.
  1003.  
  1004.         6.1  BUG REPORTING INSTRUCTIONS
  1005.  
  1006.         Please help us with future releases of OPUS Message Kit by
  1007.         reporting bugs as follows:
  1008.  
  1009.         Send to: 261/1055 with the following information:
  1010.  
  1011.              BBS side and User:
  1012.  
  1013.              What where you trying to do?
  1014.              Describe the Bug or problem.
  1015.              What is your Operating system version?
  1016.              Were you running any TSR's?
  1017.              Hardware configuration?
  1018.              Any other programs running?
  1019.              Any other information which might be helpful.
  1020.              How we can contact you if need be?
  1021.              What error message, if any, did you get?
  1022.          
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.                                   SPECIAL THANKS
  1064.          
  1065.         To Walter Cox (a.k.a. \/\/ Cox).  
  1066.         If anyone is responsible for the creation of Opus Message Kit it is
  1067.         Walter.  He started the idea for this reader by noting that a
  1068.         couple of the utilities Roland had written had some of the features
  1069.         needed for an off-line message reader.  With \/\/'s constant
  1070.         encouragement/nagging :-) - Roland developed Opus Message Kit. 
  1071.         Walter is also responsible for hours of testing and debugging and
  1072.         developed the scripts included for use with your comms program. 
  1073.         \/\/ is the moderator for a local communications echo (\/\/'s
  1074.         CommPort) here on Net 261. 
  1075.          
  1076.         To Anne Madison.  
  1077.         Sysop of The Keeping Room. Anne graciously consented to allowing
  1078.         her BBS to be the Test Bed for OMK.  She allowed The Keeping Room
  1079.         to be hung-up, grunged, and over-used by beta testers so that we
  1080.         could present to the BBS community a solid package.  In spite of
  1081.         what we did to her BBS she kept her good humor and gracious manner. 
  1082.         She is also responsible for taking the burden of the documentation.
  1083.  
  1084.          
  1085.         To Marek Majewski.  
  1086.         Sysop of the PainFrame BBS.  Marek is responsible for getting all
  1087.         of us who call ourselves PainFrame Pointers together in the first
  1088.         place.  Without him none of this would have come about because none
  1089.         of us would have met. 
  1090.          
  1091.         To the following bulletin boards and sysops participating in
  1092.         testing OPUS Message Kit. 
  1093.  
  1094.         1:261/1000     The Nerve Center                   Alan Hess 
  1095.         1:261/1040     SarComm                            Sara Grace 
  1096.         1:261/1026     The Electronic Circuit Rider       Craig Duerling 
  1097.         1:261/1055     The Keeping Room                   Anne Madison  
  1098.         1:261/1082     Wit-Tech                           Doug Wittich
  1099.  
  1100.         OTHER NET 261 TESTERS
  1101.  
  1102.                        Outside the Wall                   Rob Novak
  1103.                        Dave's Doghouse                    Dave Maczis
  1104.                        The Breezeway                      Daryl Martin 
  1105.                        AviTechnic                         Tom Hendricks
  1106.                        GreyHawk (RBBS & RIME)             Walter Ames
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.         APPENDIX 1:  SOFTWARE AND PROGRAMS RECOMMENDED FOR USE WITH OPUS
  1130.         MESSAGE KIT
  1131.  
  1132.         THE OPUS COMPUTER BASED CONVERSATION SYSTEM: Copyright 1886, 1987
  1133.         by Wynn Wagner, III. All Rights Reserved.
  1134.  
  1135.         ARCE (c) Copyright 1986-1988 by Wayne Chin and Vernon D. Buerg
  1136.         ALL RIGHTS RESERVED.
  1137.  
  1138.         PKZIP/PKUNZIP, PKARC/PKXARC, PKPAK/PKUNPAK: Phil Katz, PKware,
  1139.         Inc., 7545 N. Port Washington Rd. Suite 205, Glendale, WI 
  1140.         53217-3422
  1141.  
  1142.         QEDIT (c) Copyright SemWare (tm) 730 Elk Grove Ct., Kennesaw, Ga.
  1143.         30144-4047.
  1144.  
  1145.         PC-WRITE (c) Copyright Quicksoft, 219 First N. #224, Seattle, Wa.
  1146.         98109.
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.         APPENDIX 2:  FOR THE TECHNICALLY MINDED!!
  1196.          
  1197.         ALL THOSE LITTLE FILES!!!!  ARE NOW GONE!!
  1198.          
  1199.  
  1200.         With version 2.0 you now do not have a file for each message, but
  1201.         rather one file per message area (two counting the index file).
  1202.  
  1203.  
  1204.         HARDCOPY (c) is one of those.  It is a utility written by the 
  1205.         author of OMK and allows the user to track messages by name, and/or
  1206.         date a produce a printed output of those messages.  It is used by
  1207.         many people to keep a record of messages in a particular ECHO that
  1208.         are directed to, or sent from, them.  You may find other useful
  1209.         utilities as well.  In addition, you can write programs you might
  1210.         want to operate on OMK messages simply by knowing the format is the
  1211.         same as OPUS messages (no proprietary files to figure out). 
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.